﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>Usando um procedimento armazenado com uma contagem de atualização</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:04/01/2010 05:03:30-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">Usando um procedimento armazenado com uma contagem de atualização</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
    <font color="DarkGray">
      
    </font>
    <p />
    
    <p />
  
        <div id="introductionSection" class="section">
    <p>Para modificar dados em um banco de dados do SQL Server usando um procedimento armazenado, o Microsoft SQL Server JDBC Driver fornece a classe <a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a>. Usando a classe <b>SQLServerCallableStatement</b>, você pode chamar procedimentos armazenados que modificam dados que estão contidos no banco de dados e retornam uma contagem do número de linhas afetadas, também chamada de contagem de atualização.</p>
    <p>Depois de definir a chamada para o procedimento armazenado usando a classe <b>SQLServerCallableStatement</b>, chame o procedimento armazenado usando o método <a href="e1367f39-23d7-4e26-b160-6d988d7e6988.htm">execute</a> ou o método <a href="10ae662a-ce3c-4b24-875c-5c2df319d93b.htm">executeUpdate</a>. O método <b>executeUpdate</b> retornará um valor <b>int</b> que contém o número de linhas afetadas pelo procedimento armazenado, mas o método <b>execute</b> não retornará. Se você usar o método <b>execute</b> e quiser obter a contagem do número de linhas afetadas, chame o método <a href="e9570228-4500-44b6-b2f1-84ac050b5112.htm">getUpdateCount</a> depois de executar o procedimento armazenado.</p>
    <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
      Se você quiser que o driver JDBC retorne todas as contagens de atualização, inclusive contagens de atualização retornadas por gatilhos que possam ter sido acionados, defina a propriedade da cadeia de conexão lastUpdateCount como "false". Para obter mais informações sobre a propriedade lastUpdateCount, consulte <a href="f1b62700-f046-488d-bd6b-a5cd8fc345b7.htm">Definindo as propriedades de conexão</a>.<p />
    </div>
    <p>Como um exemplo, crie a tabela seguinte e o procedimento armazenado, e também insira dados de exemplo no banco de dados de exemplo do SQL Server 2005 AdventureWorks:</p>
    <div class="sampleCode"><span codeLanguage="other"><pre>CREATE TABLE TestTable 
   (Col1 int IDENTITY, 
    Col2 varchar(50), 
    Col3 int);

CREATE PROCEDURE UpdateTestTable
   @Col2 varchar(50),
   @Col3 int
AS
BEGIN
   UPDATE TestTable
   SET Col2 = @Col2, Col3 = @Col3
END;
INSERT INTO dbo.TestTable (Col2, Col3) VALUES ('b', 10);</pre></span></div>
    <p>No exemplo seguinte, uma conexão aberta ao banco de dados de exemplo do AdventureWorks é passada para a função, o método <b>execute</b> é usado para chamar o procedimento armazenado UpdateTestTable e, em seguida, o método <b>getUpdateCount</b> é usado para retornar uma contagem das linhas que são afetadas pelo procedimento armazenado. </p>
    <div class="sampleCode"><span codeLanguage="other"><pre>public static void executeUpdateStoredProcedure(Connection con) {
   try {
      CallableStatement cstmt = con.prepareCall("{call dbo.UpdateTestTable(?, ?)}");
      cstmt.setString(1, "A");
      cstmt.setInt(2, 100);
      cstmt.execute();
      int count = cstmt.getUpdateCount();
      cstmt.close();

      System.out.println("ROWS AFFECTED: " + count);
   }
   catch (Exception e) {
      e.printStackTrace();
   }
}
</pre></span></div>
  </div><span id="seeAlsoSpan"><h1 class="heading">Consulte também</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="0041f9e1-09b6-4487-b052-afd636c8e89a.htm">Usando instruções com procedimentos armazenados</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />
		
		<span id="fb" class="feedbackcss">
			
			
		</span>
		
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2010 Microsoft Corporation. Todos os direitos reservados.
		</a>
 	
	
      </div>
    </div>
  </body>
</html>